resizeStack

Type

message

Summary

Sent to the current card when the stack window is resized.

Syntax

resizeStack <pNewWidth>, <pNewHeight>, <pOldWidth>, <pOldHeight>

Description

Handle the resizeStack message if you want to update the position of objects or do other tasks when the stack window changes size.

The resizeStack message is sent when the user resizes the stack by dragging its size box. It is also sent if a handler changes the size of the stack by changing its properties (width, height, and so on).

The resizeStack message is sent after the resizing is finished. This means that you cannot prevent a stack's size from being changed by trapping this message.

The pOldWidth and pOldHeight for each resizeStack message is the same as the pNewWidth and pNewHeight for the previous resizeStack. The stack's original width and height are passed only with the first resizeStack message sent during a resize operation.

The screen is locked while a resizeStack handler is running, so it is not necessary to use the lock screen command to prevent changes from being seen. (However, the lockScreen property is not set to true.)

note

If the stack's vScroll property is nonzero, the amount of scroll is not included in the pNewHeight and pOldHeight. This means that the parameters of the resizeStack message are always equal to the stack's height before and after resizing, regardless of the vScroll setting.

Known issue

Currently errors in moveStack and resizeStack are ignored, as this was causing a hang in the IDE.

Parameters

Name	Type	Description
pNewWidth		The stack's new width in pixels.
pNewHeight		The stack's new height in pixels.
pOldWidth		The stack's original width in pixels.
pOldHeight		The stack's original height in pixels.

Examples

on resizeStack newWidth,newHeight -- put an object in the middle
  set the location of graphic "Middle" \
     to newWidth div 2,newHeight div 2
  pass resizeStack
end resizeStack

Related

glossary: object, property, current card, stack window, handler, message, parameter, command, trap

message: moveStack, resizeControl, unIconifyStack

object: stack

property: maxWidth, width, height, minHeight, resizable, lockScreen, properties, vScroll

command: revChangeWindowSize, lock screen

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile